home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3s / ctermid.z / ctermid
Encoding:
Text File  |  1998-10-20  |  3.9 KB  |  67 lines
  1.  
  2.  
  3.  
  4. cccctttteeeerrrrmmmmiiiidddd((((3333SSSS))))                                                        cccctttteeeerrrrmmmmiiiidddd((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_tttt_eeee_rrrr_mmmm_iiii_dddd, _cccc_tttt_eeee_rrrr_mmmm_iiii_dddd______rrrr - generate file name for terminal
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_tttt_dddd_iiii_oooo_...._hhhh_>>>>
  13.  
  14.      _cccc_hhhh_aaaa_rrrr _****_cccc_tttt_eeee_rrrr_mmmm_iiii_dddd _((((_cccc_hhhh_aaaa_rrrr _****_ssss_))))_;;;;
  15.  
  16.      _cccc_hhhh_aaaa_rrrr _****_cccc_tttt_eeee_rrrr_mmmm_iiii_dddd______rrrr _((((_cccc_hhhh_aaaa_rrrr _****_ssss_))))_;;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _cccc_tttt_eeee_rrrr_mmmm_iiii_dddd generates the path name of the controlling terminal for the
  20.      current process, and stores it in a string.
  21.  
  22.      If _s is a _NNNN_UUUU_LLLL_LLLL pointer, the string is stored in an internal static area,
  23.      the contents of which are overwritten at the next call to _cccc_tttt_eeee_rrrr_mmmm_iiii_dddd, and
  24.      the address of which is returned.  Otherwise, _s is assumed to point to a
  25.      character array of at least _LLLL______cccc_tttt_eeee_rrrr_mmmm_iiii_dddd elements; the path name is placed
  26.      in this array and the value of _s is returned.  The constant _LLLL______cccc_tttt_eeee_rrrr_mmmm_iiii_dddd is
  27.      defined in the _ssss_tttt_dddd_iiii_oooo_...._hhhh header file.
  28.  
  29.      _cccc_tttt_eeee_rrrr_mmmm_iiii_dddd______rrrr is a reentrant version of _cccc_tttt_eeee_rrrr_mmmm_iiii_dddd.  It differs from _cccc_tttt_eeee_rrrr_mmmm_iiii_dddd
  30.      only in that the parameter _s must be supplied.  The feature test macro
  31.      ______SSSS_GGGG_IIII______RRRR_EEEE_EEEE_NNNN_TTTT_RRRR_AAAA_NNNN_TTTT______FFFF_UUUU_NNNN_CCCC_TTTT_IIII_OOOO_NNNN_SSSS should be defined to make this function visible.
  32.  
  33. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  34.      _tttt_tttt_yyyy_nnnn_aaaa_mmmm_eeee(3C).
  35.  
  36. WWWWAAAARRRRNNNNIIIINNNNGGGG
  37.      _cccc_tttt_eeee_rrrr_mmmm_iiii_dddd should not be called with _s equal to a NNNNUUUULLLLLLLL pointer in a
  38.      multithreaded application due to the use of an internal static buffer for
  39.      the return value.
  40.  
  41. NNNNOOOOTTTTEEEESSSS
  42.      The difference between _cccc_tttt_eeee_rrrr_mmmm_iiii_dddd and _tttt_tttt_yyyy_nnnn_aaaa_mmmm_eeee(3C) is that _tttt_tttt_yyyy_nnnn_aaaa_mmmm_eeee must be
  43.      handed a file descriptor and returns the actual name of the terminal
  44.      associated with that file descriptor, while _cccc_tttt_eeee_rrrr_mmmm_iiii_dddd returns a string
  45.      (_////_dddd_eeee_vvvv_////_tttt_tttt_yyyy) that will refer to the terminal if used as a file name.  Thus
  46.      _tttt_tttt_yyyy_nnnn_aaaa_mmmm_eeee is useful only if the process already has at least one file open
  47.      to a terminal.
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.